home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Leser 19 / Amiga Plus Leser CD 19.iso / Tools / Emulatoren / GameBoy / VGB_Amiga_0.3 / VGB.doc < prev    next >
Text File  |  1995-10-19  |  13KB  |  300 lines
  1.  
  2.  
  3.                    ******* Virtual GameBoy *******
  4.                 The Portable Nintendo GameBoy Emulator
  5.                              version 0.3
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                        email: fms@wam.umd.edu
  10.                             IRC:  RST38h
  11.                WWW:  http://www.cs.umd.edu/users/fms/
  12.  
  13.  
  14.                       Matthias Bethke & Michael Boese
  15.                    http://wwwstud.uni-giessen.de/~s1089/
  16.  
  17. ******* original documentation for the X11 version ********
  18.  
  19.  
  20.          (*) GameBoy is a registered trademark of Nintendo.
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                           * INTRODUCTION *
  28.  
  29.   Virtual GameBoy [VGB] is a portable emulator of the Nintendo GameBoy 
  30. portable videogame console written in C. Although it is an initial 
  31. release of the emulator in which many things do not quite work yet, it 
  32. was able to run about 85% of 80 games checked with it. You can always
  33. get the latest VGB source code and support files from
  34.  
  35.     http://www.cs.umd.edu/users/fms/GameBoy/VGB.html
  36.  
  37.   There are two different VGB distributions which are both covered by 
  38. this manual:
  39.  
  40. 1. *** Source Code Distribution ***
  41.   This distribution contains C sources of the emulator, and the 
  42. screen/keyboard drivers for Unix/X. Virtual GameBoy has been tested on 
  43. the following Unix systems:
  44.  
  45.   SunOS   Solaris   OSF/1   FreeBSD   HP/UX   Linux   AIX 3.2.5
  46.  
  47.   It was also successfully run on a Mac, Amiga, and Atari Falcon, 
  48. although no decent ports are available for these platforms yet.
  49.   If you would like to write new drivers, or port VGB to another platform, 
  50. *please*, contact me by email or some other means. Feel free to look at 
  51. existing drivers as well as at the other code.
  52.  
  53. 2. *** VGB-Windows Distribution ***
  54.   Due to the flood of requests from the people who use DOS/Windows 
  55. running PCs and are unable to compile the emulator on their own, I have 
  56. ported VGB under Microsoft Windows. This distribution contains an
  57. executable of a limited version of VGB-Windows which doesn't allow you to 
  58. reload a new game from a menu when emulation is already running, and has 
  59. an annoying "Virtual GameBoy DEMO" message across its window. The 
  60. uncrippled version of VGB-Windows is available for $35US from
  61.  
  62.   Marat Fayzullin
  63.   6304 Hampton Place
  64.   Elkridge, MD 21227
  65.   USA
  66.  
  67.   VGB-Windows is a 32-bit application which runs under Windows 3.11, 
  68. Windows 95, and Windows NT. It is compiled with Borland C++ and needs 
  69. Microsoft WinG library which can be obtained from
  70.  
  71.   ftp://ftp.microsoft.com/Softlib/MSFILES/WING10.EXE
  72.  
  73.  
  74.  
  75.  
  76.                       * NEW IN THIS VERSION *
  77.  
  78. o Windows version is made.
  79. o Some heavy magic is done on the interrupts.
  80. o Palette registers are writable now.
  81. o Sprite display routine is changed.
  82. o Sprites are now clipped properly at the top and bottom boundaries.
  83. o -delay/-nodelay option is added.
  84. o etc.
  85.  
  86.  
  87.  
  88.                * SHORT MANUAL FOR THE WINDOWS USERS *
  89.  
  90.   In order to use VGB-Windows, you will first have to install WinG
  91. graphical library which can be obtained from Microsoft [see address
  92. above]. Also, the VGB-WIndows distribution contains a file called
  93. BWCC32.DLL which should be either kept in a directory from which
  94. VGB runs, or copied into \WINDOWS\SYSTEM directory.
  95.   VGB-Windows runs in a resizable window with the following menus:
  96.  
  97. o File
  98.   o New
  99.     This opton allows to run a new game. If you only have an unregistered
  100.     version of VGB-Windows, it will be disabled so that you will only be
  101.     able to choose a game when emulator starts.
  102.   o Setup
  103.     This option pops up a setup dialog allowing to change all 4 GameBoy's
  104.     colors and some emulation parameters:
  105.     o Palette
  106.       Use this group of controls to select a color and change its RGB
  107.       components. The palette controls may not work very well if you
  108.       run Windows in 256-color mode. Use 16-bit or 24-bit graphical
  109.       mode for best effect. 
  110.     o VBlank Period
  111.       This parameter determines how many CPU commands will be executed
  112.       between vertical blanking interrupts. Setting it lower may speed
  113.       up the emulation, but setting it too low will hang it.
  114.     o Update Period
  115.       This parameter determines how many vertical blanking interrupts
  116.       will pass between window refreshes. It is usually set to 2, but
  117.       you can increase it to make VGB work faster. The sprite
  118.       movements become jerky at high update periods though, and some
  119.       sprites may simply disappear.
  120.     o Delay Line Interrupts
  121.       If you see "dirty" horizontal lines in some games, you may turn
  122.       this option on or off to remove them. There is no some universal
  123.       state of this option which will work for all games though.  
  124.   o Quit
  125. o Size
  126.   o 1:1  These options change the window size to be the same as in real
  127.   o 2:1  GameBoy, or 2/3/4 times bigger. Please, note that you can change
  128.   o 3:1  window size by simple dragging the bottom-right corner of a
  129.   o 4:1  window with the mouse.
  130. o Help
  131.   o About
  132.     This option will display a dialog box with copyright information
  133.     and other legal stuff.
  134.  
  135.  
  136.  
  137.                    * FREQUENTLY ASKED QUESTIONS *
  138.  
  139. 1. What is GameBoy?
  140.   GameBoy is a handheld videogame machine produced by Nintendo. It is 
  141. built around a custom CPU similar to Z80, but with some changes. GameBoy 
  142. is frequently laughed at because of its reflective green-on-yellow LCD 
  143. screen which in fact is its virtue. Due to the low power consumption of 
  144. its LCD, GameBoy can work for 35 hours off 4 AA batteries. There is a lot 
  145. of good games produced for GameBoy, both classics [Tetris, Pacman, 
  146. Asteroids, etc.] and specific ones [Final Fantasy series for GB]. It 
  147. excells in RPGs and classic games where gameplay is more important than 
  148. graphics. More information about GameBoy is available from
  149.  
  150.                 http://www.cs.umd.edu/users/fms/GameBoy/
  151.  
  152. 2. Where do I get GameBoy games?
  153.   You buy the cartridges. GameBoy software is copyrighted and still sold. 
  154. Therefore, its distribution is an act of piracy. Nothing prohibits you 
  155. from backing up a cartridge you own and playing it on the emulator though.
  156. To back up a GameBoy cartridge, you can use either SmartCard copier [about
  157. $100 for a standalone version], or a self-built copier, description of
  158. which will hopefully be available at the WWW page soon.
  159.  
  160. 3. Is it legal to spread GameBoy cartridge snapshots?
  161.   NO. Be aware of the fact that by using commercial software you haven't 
  162. bought, you are commencing an act of piracy. Not that I care, anyway...
  163.  
  164. 4. What are the keys used in VGB?
  165.   VGB Unix/X keys:
  166.  
  167.   [SPACE] - A button
  168.   [LALT]  - B button                        ([CONTROL] in Windows)
  169.   [TAB]   - SELECT button
  170.   [ENTER] - START button
  171.   [ESC]   - Quit emulation
  172.   [F1]    - Turn tracing on/off             (Not implemented in Windows)
  173.   [F2]    - Show LCD controller registers   (Not implemented in Windows)
  174.  
  175. 5. Where is the complete list of command line options of VGB?
  176.   Use -help option. It will tell VGB to display all options available in 
  177. your version. Following are the options available in VGB-Unix/X:
  178.  
  179.   -verbose <level>    - Select debugging messages [5]
  180.                         0 - Silent           1 - Startup messages
  181.                         2 - Illegal writes   4 - Illegal CPU ops
  182.                         8 - Bank switching
  183.   -vperiod <period>   - Set VBlank interrupts period [10000ops]
  184.   -uperiod <period>   - Number of interrupts per screen update [2]
  185.   -help               - Print this help page
  186.   -cheat <GG code>    - Activate a GameGenie cheat [not supported yet]
  187.   -shm/-noshm         - Use/don't use MIT SHM extensions for X [-shm]
  188.   -trap <address>     - Trap execution when PC reaches address [FFFFh]
  189.   -delay8øøæE…bôâ‹æE…bô…bô€ãŒ€    ¦…b˜Í…bôùURíùJÌ®ŒŒ®Œˆ®iø˜.,®iä…bôíÍ欏æEâ‹®jxùi¦…bô…bôø„ùRð€ãŒùpâù¦¸íí®Œˆí®Œˆ±lô˜.,š²<ˆf,]
  190.   -color2 ®k¸ù\…2Âííí®Œˆ±lô€ãŒ <name8  ø ,Wš²±m…5̱m€    ¦®Ø®ŒtWùSܱmùU^ùURWùJÌ®ŒŒ®Œˆ,®k emula®k®ØtWš²±m…5̱mo, some ®kˆ欁€ãŒù•±m
  191. ±m®¬Ÿøˆ±mù”Â…D„€ãŒ±m±m…6N欁±m欁±m±m™"î±Hí™"ˆŸøî€ãŒ±°
  192. Ÿøî±Ö®lP±¤™"îsŒˆ±±lÌ™Š|±ö±F®ŒŒ®Œˆ™Š|ŸøˆŸú²gely, try -delay/-nodelay options, or check/clear the "Delay
  193.   Line Interrupts" checkbox in the VGB-Windows setup window. 
  194. o If some sprites blink or do not appear at all, try changing -uperiod
  195.   value from 1 to 10 [1 will give you the best picture, but the slowest
  196.   emulation], or moving an "Update Period" knob in the VGB-Windows
  197.   setup window.
  198.  
  199. 7. Palette controls in VGB-Windows do not work.
  200.   This probably means that you are running Windows in the 256-color
  201. mode. In this mode, not all of 256 possible colors are available, and
  202. you will be able to choose only from the available colors. Switch
  203. Windows into 16-bit or 24-bit graphics and palette will start working.
  204.  
  205. 8. I start VGB-WIndows, but it tells me that WING.DLL is not found.
  206.   This means that you haven't installed WinG library necessary to run
  207. VGB. Check the informati`,– ®s¼on in the beginning of this manual on how to
  208. obtain WinG.
  209.  
  210. 9. I start VGB-WIndows, but it tells me that BWCC32.DLL is not found.
  211.   VGB-Windows comes with a file called BWCC32.DLL. This file should
  212. be either kept in the directory from which VGB runs, or put into
  213. \WINDOWS\SYSTEM directory.
  214.  
  215. 10. Why is VGB so slow on my computer?
  216.   Because your computer is too slow to run VGB. VGB is written entirely in
  217. C language and therefore is quite slow. Although it works on 486/33 and even 
  218. 386/33 PCs, it runs best on a Pentium/90 or a DEC Alpha/150. You can try to 
  219. speed it up by increasing -uperiod value controlling the number of vertical
  220. blanking impulses between screen updates to 3-6, and by decreasing -vperiod
  221. value controlling the number of CPU cycles between vertical blanking
  222. impulses to 3000-6000. Please, DO NOT SEND ME MAIL about VGB speed.
  223.  
  224. 11. Can I compile VGB with my Borland/Turbo C compiler?
  225.   You can, given that your compiler creates executables using flat 32bit 
  226. memory model. Two PC compilers which do that @ ®wÌare WATCOM [using DOS4GW DOS 
  227. extender] and GCC [using DJPP extender]. The only Borland/Turbo C 32-bit 
  228. compiler that I'm aware of is for Windows.
  229.  
  230. 12. When compiling VGB under Unix, I get "undefined name" errors.
  231.   This means that your linker can not find the libraries necessary
  232. for VGB [namely, libX11.a and libXext.a]. Find these libraries in
  233. your system and modify the Makefile so that the final invocation
  234. of the C compiler has "-L<path_to_libs>" options. If the errors
  235. persist, try #undefining MITSHM option.
  236.  
  237. 13. When starting VGB-Unix/X, I get X_ShmAttach error.
  238.   You are probably trying to run VGB on a remote Xterminal while it 
  239. attempts to use shared memory for interfacing with X. Use -noshm option 
  240. to tell VGB not to use shared memory.
  241.  
  242. 14. VGB starts under Unix, but then I get X_PutImage error.
  243.   Unix/X version of VGB currently needs 256-color X. Neither 2-color 
  244. nor TrueColor Xterminals will work with the drivers included into 
  245. "official" VGB distribution.
  246.  
  247. 15. I start VGB-Unix/X but the window stays p ®{Üblack.
  248.   Some other X application took over all available colors so that VGB 
  249. could not allocate any for itself. Check if you run XV, Netscape, or 
  250. something similar.
  251.  
  252. ---------------
  253. Marat Fayzullin
  254.  
  255.  
  256.  
  257.  
  258.  
  259. ******* changes in the Amiga version *******
  260.  
  261. - recompiled with SAS/C V6.30
  262. - requires OS 3.0 and 68020 minimum
  263. - key assignments changed, press "help" for an info requester
  264. - does not support a filename on the commandline, instead an ASL
  265.   filerequester is used
  266. - tested on: A4000/040, CV64 (playable)
  267.              A2000/030, ECS  (sloooooooowwww!)
  268.  
  269. History:
  270. V0.2: first port of the X11 version. Not optimized in any way
  271. V0.3: applied changes of the X11 V0.3, still no Amiga optimization
  272.       (assembler-coded graphics conversion is being worked on...)
  273.  
  274. To do:
  275. - speed up graphics
  276.   We took the graphics routines straight from the X11 version which uses
  277.   256-color chunky bitmaps. Speed is quite decent on a 4000/040 with
  278.   chunky-mode graphics board but unusable on ECS. Rewriting the display
  279.   format conversions s ô` Ehould give a *big* speedup here.
  280. - implement sound
  281.   Pretty difficult to do...as we understand it, you'd need 8 audio channels
  282.   to do this without too much work for the CPU.
  283. - better user interface, maybe some GadTools stuff. NO, we will NOT use MUI
  284.   for this one :)
  285. - support for the CD32 joypad (an ordinary joystick doesn't have enough
  286.   buttons)
  287. - real disassembler and hex editor with save function ("freezer")
  288.  
  289. Not really:
  290. - contrast/brightness control
  291. - 4-player support (serial cable emu) via AmiTCP sockets
  292. - battery LED emulation
  293.  
  294.  
  295. If you have any suggestions or ideas for future versions, contact us at
  296. these email addresses:
  297. Matthias Bethke: Matthias.Bethke@sowi.uni-giessen.de
  298. Michael Boese  : skywalker@sweetdreams.lahn.de
  299.  
  300. ...or on the following boa